home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / util / libs / graphics3d.lha / doc / graphics3d.notes < prev   
Encoding:
Text File  |  1999-02-16  |  4.6 KB  |  136 lines
  1. ******** ENGLISH  ****************************************
  2.  
  3.  -----  GENERAL NOTES OVER GRAPHICS3D.LIBRARY ------
  4.  
  5. (from the original documentation of Maciej R.Gorny)
  6.  
  7. 1)    3D coordinates system
  8.  
  9. Coordinate system used is a left-handed coordinate system: X-axis goes from left
  10. to right, Y-axis, from down up-wards, and Z-axis from behind (us) into the
  11. screen.
  12.  
  13.                ^ +Y
  14.                |        Into the screen
  15.                |
  16.                |      +Z
  17.                |     /
  18.                |    /
  19.                |   /
  20.                |  /
  21.                | /
  22.                |/
  23. -X ---------------------------> +X
  24.               /|
  25.              / |
  26.             /  |
  27.            /   |
  28.           /    |
  29.        -Z/     |
  30.                |
  31.  Viewer        | -Y
  32.  
  33.  
  34. 2)    Objects and polygons supported
  35.  
  36. The objects are group of polygons of two types:
  37. The first with three vertices (triangles) or with four vertices (quads) in clockwise order and with one or two side .
  38. The second with one(point) or two(lines) vertex, obiouvsly with this entitys
  39. the caratteristics of first type here are ignored.
  40. All other will be either rejected or will cause problems.
  41.  
  42. One-sided polygons will be visible only when they are facing a viewer. 
  43. This is useful if we want to limit number of polygons rendered to screen by 
  44. using backface culling and remove polygons that cannot be seen in an object.
  45. Objects cannot concave in such case.
  46.  
  47. Two-sided polygons will always be rendered to a screen (provided they get
  48. passed clipping procedures), because they have two sides that are visible to
  49. a viewer: front and back.
  50.  
  51.  
  52. 3)    Limits
  53.  
  54. In the space 3D defined with the function GD_display3D() you can insert a
  55. max of 200 objects (you can change recompiled with a new value for MAXOBJECT
  56. see graphics3d.h) and for any objects you can define a max of 6300 vertex 
  57. (you can change recompiled with a new value for MAXVERT see graphics3d.h).
  58. In the 2D visualization window the max box usable is of 3000x3000 pixel.
  59. I think that this value generally sufficent for all, but if you increase
  60. its warnig! because the memory usage is not too linear.
  61.  
  62. 4) New custom object format 
  63.  
  64. To convert the old plg object or use object in TDDD format (Imagine ASCII format)
  65. use the conv program , for the use istruction run it with the -help option.
  66.  
  67. ******** ITALIANO ****************************************
  68.  
  69.  -----  NOTE GENERALI SULLA GRAPHICS3D.LIBRARY -----
  70.  
  71. (tratto dalla documentazione originale di Maciej R.Gorny)
  72.  
  73. 1)    Sistema di coordinate nello spazio
  74.  
  75. Il sistema sistema di coordinate usate segue la regola della mano sinitra
  76. cioe' : l'asse X va da sinistra a destra , l'asse Y va dal basso in alto
  77. e l'asse Z entra nello schermo
  78.  
  79.                ^ +Y
  80.                |        Verso lo schermo
  81.                |
  82.                |      +Z
  83.                |     /
  84.                |    /
  85.                |   /
  86.                |  /
  87.                | /
  88.                |/
  89. -X ---------------------------> +X
  90.               /|
  91.              / |
  92.             /  |
  93.            /   |
  94.           /    |
  95.        -Z/     |
  96.                |
  97.  osservatore   | -Y
  98.  
  99.  
  100. 2)     Oggetti e poligoni supportati.    
  101.  
  102. Gli oggetti sono intesi come insiemi di poligoni di due tipi :
  103. Il primo con tre(triangoli) o quattro (quadrilateri)vertici in ordine orario
  104. e con una o due facce, non sono ammessi altri casi.
  105. Il secondo con uno (punto) o due (linee)vertici ovviamente con queste due
  106. entita' non hanno senso le caratteristiche associate ai poligoni del
  107. primo tipo qui del tutto ignorate. 
  108.  
  109. I poligoni con una faccia saranno visibili solo se saranno rivolti verso
  110. l'osservatore (ovvero con la faccia esterna all'oggetto).Questo e' utile
  111. per limitare il numero di poligoni visualizzati sullo schermo.
  112. L'oggetto in tal caso non deve essere aperto.
  113.  
  114. I poligoni con due facce saranno invece sempre visibili sullo schermo
  115. poiche' hanno due lati visibili all'osservatore : anteriore e posteriore.
  116.  
  117.  
  118. 3)    Limiti
  119.  
  120. Nello spazio 3d definito con la funzione GD_display3D() si possono inserire
  121. un massimo di 200 oggetti (si puo' variare ricompilando con un valore 
  122. diverso per MAXOBJECT vedi graphics3d.h) e per ogni oggetto si puo' definire 
  123. un massimo di 6300 vertici (si puo' variare ricompilando con un valore diverso 
  124. per MAXVERT vedi graphics3d.h) .
  125. Nello spazio 2D della finestra di visualizzazione le dimensioni massime del box
  126. sono di 3000x3000 pixel.
  127. In ogni caso penso siano valori generalmente sufficenti e se li aumentate
  128. attenzione all'uso della memoria perche' aumentera in modo non troppo 
  129. lineare.
  130.  
  131. 4) Nuovo formato propietario per oggetti
  132.  
  133. Per convertire in vecchi oggetti plg o per usare oggetti nel formato TDDD (formato Imagine ASCII)
  134. usa il programma conv, per le istruzioni d'uso lanciarlo con l'opzione -help.
  135.  
  136.